CRPEJob::SetFont

Syntax
SetFont (sectionCode SMALLINT, scopeCode SMALLINT, faceName CHAR (*), 
fontFamily SMALLINT, fontPitch SMALLINT, charSet SMALLINT, pointSize 
SMALLINT, isItalic SMALLINT, isUnderlined SMALLINT, isStruckOut 
SMALLINT, weight SMALLINT) RETURNING BOOLEAN
Parameters

sectionCode

Specifies the section of the report for which you want to set the font. Use one of the following values:

Value Meaning


PEP_ALLSECTIONS

Sets the line height for all sections.


PEP_HEADERSECTION

Sets the line height for the Page Header section.


PEP_GROUPHEADER

Sets the line height for the Group Header section.


PEP_DETAILSECTION

Sets the line height for the Details section.


PEP_GROUPFOOTER

Sets the line height for the Group Footer section.


PEP_GRANDTOTALSECTION

Sets the line height for the Grand Total section.


PEP_FOOTERSECTION

Sets the line height for the Page Footer section.

scopeCode

Specifies whether the font selected is to apply to fields, to text, or to both. To specify both, use the bitwise Or operator: |. The following values are possible:

Value Meaning


PEP_FIELDS

Sets the default font for fields in the report section specified.


PEP_TEXT

Sets the default font for all text (that has not been entered as a text field value) in the report section specified.

faceName

Specifies the actual face name of the font you want to use. The face name you pass can typically come from a font dialog box, be hard coded in the application, or be chosen by the application from the fonts supported on the printer. For example: "Times New Roman".

fontFamily

Specifies the font family for the font you want to use. Use one of the following values:

Value Meaning


FF_DONTCARE

No font family or family does not matter.


FF_ROMAN

Variable pitch font with serifs.


FF_SWISS

Fixed pitch font without serifs.


FF_MODERN

Fixed pitch font, with or without serifs.


FF_SCRIPT

Handwriting-like font.


FF_DECORATIVE

Fancy display font.

fontPitch

Specifies the font pitch you wish to use. Use one of the following values:

Value Meaning


DEFAULT_PITCH

Retains the default pitch for the font.


FIXED_PITCH

Fixed pitch, each character is the same width.


VARIABLE_PITCH

Variable pitch, the width of each character varies.

charSet

Specifies the character set you wish to use. Use one of the following values:

Value


ANSI_CHARSET


DEFAULT_CHARSET


SYMBOL_CHARSET


HANGEFUL_CHARSET


OEM_CHARSET


SHIFTJIS_CHARSET


CHINESEBIG5_CHARSET

pointSize

Specifies the desired point size for the selected font. Use 0 to indicate no change.

isItalic

Specifies whether the font selected should be italicized. Use 1 for italics, 0 for no italics, or PEP_UNCHANGED to leave the italics as set up in the report.

isUnderlined

Specifies whether the font should be underlined. Use 1 to underline, 0 for no underline, or PEP_UNCHANGED to leave underline settings as specified in the report.

isStruckOut

Specifies whether or not the font should appear in strikethrough format. Use 1 for strike-out, 0 for no strike out, or PEP_UNCHANGE to leave strike-out settings as specified in the report.

weight

Specifies the weight of the font. Possible values are:

Value


FW_DONTCARE


FW_EXTRALIGHT


FW_NORMAL


FW_SEMIBOLD


FW_EXTRABOLD


FW_ULTRALIGHT


FW_DEMIBOLD


FW_BLACK


FW_THIN


FW_LIGHT


FW_MEDIUM


FW_BOLD


FW_HEAVY


FW_REGULAR


FW_ULTRABOLD

Remarks

This method sets the font and font characteristics for the specified section. Use any time you need to change a default font at runtime in response to user input, or to specify a built-in printer font.

Returns
Related Topics

PESetFont



Seagate Software IMG Holdings, Inc.
http://www.seagatesoftware.com
Support services:
http://support.seagatesoftware.com